home *** CD-ROM | disk | FTP | other *** search
/ Cobra Utilities for Doom & Doom II / Cobra Utilities For Doom & Doom II - Disc 1.iso / files / level / dmclei / dshrink.txt < prev    next >
Encoding:
Text File  |  1994-08-20  |  2.5 KB  |  74 lines
  1. This is the *.txt file for dshrink.
  2.  
  3. =====================
  4. DSHRINK - WHAT IS IT?
  5. =====================
  6.  
  7. Dshrink is a program for removing redundant sidedefs from PWADS.  It turns
  8. out that PWADS don't need all the sidedefs they typically come with.
  9. If two sidedefs in the same sector are identical, DOOM can just as easily
  10. paint both walls using either sidedef, making the other redundant.
  11.  
  12. Dshrink greatly reduces the size of PWADS, typically removing over 50%
  13. of the sidedefs.  "The Ungathered", the eighth level of Cleimos,
  14. built with deu and run through wad_dwd and idbsp, weighs in at 300k before
  15. dshrink, and 244k after.  About 1850 sidedefs were redundant, thus removed.
  16.  
  17. Also, since PWADS are examined dynamically as DOOM runs, smaller PWADS
  18. should mean a faster game.
  19.  
  20. ==============
  21. *** CAVEAT ***
  22. ==============
  23.  
  24. ************** Dshrink's output is useless as input to a level editor.
  25. ************** The editor (deu in our case) reads the PWAD just fine, but
  26. ************** if you change a sidedef, any other linedefs using it will
  27. ************** inherit the change.  This makes editing very painful.
  28.  
  29. ************** DO NOT MAKE THE MISTAKE OF WIPING OUT YOUR INPUT FILE BY
  30. ************** RENAMING YOUR DSHRINK OUTPUT (TMP.WAD) TO THE NAME OF THE
  31. ************** INPUT FILE.  WE ARE NOT RESPONSIBLE FOR YOUR MISTAKES.
  32.  
  33. ==================
  34. HOW TO USE DSHRINK
  35. ==================
  36.  
  37. Dshrink was built using DJGPP (DJ's GCC port to DOS), and requires
  38. that GO32.exe is in the search path.  If you have GO32 already, you're
  39. set.  If not, a copy is included. 
  40.  
  41. After you've done binary space partitioning on your level (bsp, idbsp, etc.),
  42.  
  43.     (Assuming that dshrink.exe and go32.exe are present in your
  44.      working directory...)
  45.      
  46.      > set GO32TMP=c:\            /* only needed once per session */
  47.      > dshrink <your_pwad_name>   /* doesn't change your pwad     */
  48.  
  49. This creates the file tmp.wad, which you can then play.  REMEMBER
  50. NOT TO RENAME IT BACK TO YOUR ORIGINAL PWAD NAME!  THIS WILL MAKE LEVEL
  51. EDITING A BIT PAINFUL!
  52.  
  53. ======
  54. SOURCE
  55. ======
  56.  
  57. Source is included in the file dshrink.c.
  58.  
  59. =====
  60. NOTES
  61. =====
  62.  
  63. 1. This program is only to be used with wads designed to work with the
  64.    registered version of DOOM.
  65.  
  66. 2. If you distribute dshrink, you must also distribute the original source
  67.    and this dshrink.txt file.
  68.  
  69. 3. DOOM is a registered trademark of id Software, Inc.
  70.  
  71. 4. If you have any problems with this program, please contact us at
  72.    phares@dg-rtp.dg.com.
  73.  
  74.